home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / UTILFILE / COPYIT10.LZH / COPYIT.DOC next >
Text File  |  1988-10-11  |  21KB  |  733 lines

  1.  
  2.  
  3.           .
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                                    COPYIT
  25.                                    ------
  26.  
  27.                                  Version 1.0
  28.                                October 12, 1988
  29.  
  30.                               File Copy Utility
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.                                Contech Systems
  53.                                 P.O. Box 396
  54.                           Sterling Heights, MI 48311
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.           INTRODUCTION
  71.           ------------
  72.  
  73.                COPYIT is  a file copy utility designed to be much
  74.           more complete  than  the  standard  DOS  COPY  command.
  75.           Using COPYIT, you can:
  76.  
  77.               *  Have COPYIT prompt you before copying each file,
  78.  
  79.               *  Have COPYIT  check to make sure no files will be
  80.                  overlaid,
  81.  
  82.               *  Spread   your   copying   over  multiple  target
  83.                  diskettes; when a     diskette  is  full, COPYIT
  84.                  will  prompt  you  to  insert      another, then
  85.                  continue,
  86.  
  87.               *  Move  files,  saving  you  from having to delete
  88.                  what you just    copied,
  89.  
  90.               *  Copy files bases on date or size criteria,
  91.  
  92.               *  Copy files that are read-only, hidden, or system
  93.                  files,
  94.  
  95.               *  Copy files based on the archive  bit,  and reset
  96.                  that bit if   desired,
  97.  
  98.               *  Optimize while  copying  to  diskettes  - COPYIT
  99.                  will  attempt      to  fill  the   diskettes  as
  100.                  completely  as possible, before   prompting  for
  101.                  another diskette,
  102.  
  103.               *  COPYIT will verify while copying, if specified.
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.           Copyright (c) 1988, Contech Systems
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.                                    - 2 -
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.           REGISTRATION
  138.           ------------
  139.  
  140.                COPYIT  is  distributed  and  marketed  under  the
  141.           Shareware concept.  You may freely distribute copies of
  142.           COPYIT, as long as  it  is  in the original, unmodified
  143.           form.    It  may not, however, be  bundled  with  other
  144.           software packages without prior written permission from
  145.           Contech Systems.
  146.                You  may  freely   use  COPYIT  for  a  reasonable
  147.           evaluation period not to  exceed  thirty  days.  If you
  148.           find  it  useful  and  continue  to  use  it after  the
  149.           evaluation   period,   you   are   required  to  pay  a
  150.           registration fee as follows:
  151.  
  152.                A)  $ 8.00     Register Only
  153.                B)  $12.00     Register, and receive next version
  154.  
  155.                Plan A registers your copy,  and  entitles  you to
  156.           product support.   Under  plan B, you will also receive
  157.           the  newest   version  of  COPYIT  as  soon  as  it  is
  158.           available.  To register, simply print and  complete the
  159.           registration  form  included  with  COPYIT (in the file
  160.           REGISTER.FRM), enclose check or money orders payable to
  161.           Contech Systems, and send to:
  162.  
  163.                         Contech Systems
  164.                         P.O. Box 396
  165.                         Sterling Heights, MI 48311
  166.  
  167.                         ATTN: COPYIT Registration
  168.  
  169.                Contech  Systems has an excellent upgrade  policy.
  170.           Registrations  are  considered  valid  for   ALL  minor
  171.           versions  within that major version (the major  version
  172.           number is the number to the left of the decimal - minor
  173.           version numbers are  to  the right).  Simply notify us,
  174.           and  you  registration  will  be  changed  to  the  new
  175.           version.  When the major  version  number  changes, you
  176.           may upgrade your registration for a nominal fee.
  177.                At any time, you may request the latest version of
  178.           COPYIT for $5.00 to cover  the cost of the diskette and
  179.           postage.
  180.  
  181.           DISCLAIMER
  182.           ----------
  183.  
  184.                Under  no  circumstances  shall Contech Systems or
  185.           its  suppliers  be  liable  for any damages whatsoever,
  186.           including but not limited to loss  of  business profits
  187.           or information,  business  interruption,  or  any other
  188.           loss  arising  out  of the use or inability to use this
  189.           software product.
  190.  
  191.  
  192.  
  193.  
  194.                                    - 3 -
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.           COPYIT Operation
  205.           ----------------
  206.  
  207.                COPYIT is very easy to use.  If  you  are familiar
  208.           with the standard DOS COPY command, you can already use
  209.           COPYIT in its place for  copying.  To take advantage of
  210.           the special features  of  COPYIT,  it  is  necessary to
  211.           become  familiar with various parameters which will  be
  212.           described later.
  213.                COPYIT  commands are entered from the DOS  prompt,
  214.           in the following format:
  215.  
  216.             COPYIT      [copyfrompath\mask]     [Copytopath\mask]
  217.           [/p1../pn]
  218.  
  219.           Copyfrompath\mask is the drive, path, and mask  for the
  220.           files you  want to copy.  Copytopath\mask is the drive,
  221.           path,  and  mask  you  want  the files copied  to,  and
  222.           [/p1../pn]  are the command parameters, each  beginning
  223.           with a '/', and separated by a space.
  224.                Masks are entered in the identical format that DOS
  225.           uses, including wildcards.   Specifying  a  copyto mask
  226.           will result  in files being renamed as they are copied.
  227.           For example, if
  228.  
  229.                    COPYIT a:*.* c:?Z*.new
  230.  
  231.           were entered, the result would be that all files in the
  232.           current  directory on disk A would  be  copied  to  the
  233.           current directory on drive  C,  and  the files would be
  234.           renamed.    The  new  names  would be the same as  they
  235.           originally were, except that the second letter  in each
  236.           name would become 'Z' and the  extensions  would become
  237.           .NEW .  For example, a file named  APPLES.BAK  would be
  238.           renamed AZPLES.NEW.   Refer to your DOS manual for more
  239.           information on masks and wildcards.
  240.                If  no  copyfrom mask is  specified,  COPYIT  will
  241.           target all  files in the specified subdirectory.  If no
  242.           copyto mask is entered, COPYIT assumes you wish to copy
  243.           the files to the current drive/directory.
  244.                Parameters (discussed below) must be entered after
  245.           the  above  path\mask  indicators.   Parameters must be
  246.           preceded by a slash (/),  and each must be separated by
  247.           a space.
  248.  
  249.  
  250.           Copying Many Files
  251.           ------------------
  252.  
  253.                Many times it is necessary  to  copy  a  number of
  254.           files  from  a  large subdirectory on a  hard  disk  to
  255.           diskettes.  Using the standard DOS copy  commands, this
  256.           is virtually impossible - as soon as the first diskette
  257.           is out of space, the copy command aborts.    Typing the
  258.  
  259.  
  260.  
  261.                                    - 4 -
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.           individual   file   names   is  inconvenient  and  time
  272.           consuming;  altering the archive bit is undesirable  if
  273.           you   make  backups.    COPYIT  solves  this   problem.
  274.           Whenever the current diskette is out  of  space, COPYIT
  275.           will prompt you to insert a new one, and press  any key
  276.           to  continue.    COPYIT will then pick up where it left
  277.           off.  This function is always active; you  do  not need
  278.           to specify any  parameters  to  use  it.  If you do not
  279.           have another diskette  available,  or  do  not  want to
  280.           spread  the  copy  between  multiple diskettes, you may
  281.           press ESC at the prompt  for  another  diskette  - this
  282.           will halt the copy operation.
  283.  
  284.  
  285.           Aborting a File Copy
  286.           --------------------
  287.  
  288.                Pressing the escape key (ESC) at any time during a
  289.           copy  operation will halt it.   If  COPYIT  is  already
  290.           copying a particular file, it does not abort until that
  291.           file copy is complete.
  292.  
  293.  
  294.           Parameters
  295.           ----------
  296.  
  297.                Parameters are  the heart of COPYIT.  If you don't
  298.           use them, the only  thing  you  gain  over the DOS COPY
  299.           command  is  the prompt for  inserting  another  target
  300.           diskette  if  there  is  not  enough   space   to  copy
  301.           everything specified.
  302.  
  303.             /p - prompt as to whether a file should be copied.
  304.             /h - copy Hidden files.
  305.             /s - copy System files.
  306.             /r - copy Read-Only files.
  307.             /c - check for overlay before copying.
  308.             /z - copy based on file size.
  309.             /d - copy based on file date.
  310.             /a - copy based on file archive bit.
  311.             /@ - reset archive bit on files copied.
  312.             /v - Verify while copying.
  313.             /m - move files.
  314.             /o - optimize while copying.
  315.             /t - place current date and time on copied files.
  316.             /w - wait for keypress between file copies.
  317.  
  318.  
  319.           You can see this summary at any time by entering COPYIT
  320.           with no other parameters from the DOS prompt.
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                                    - 5 -
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.                Parameters may be entered in any order, as long as
  339.           they   follow   the   copyfrom   and  copyto  (if  any)
  340.           path/masks.    If  you  make  any  errors  in  entering
  341.           parameters,   COPYIT   will   respond   with   messages
  342.           describing what is wrong.  If COPYIT detects any errors
  343.           with input parameters, NO copying will take place.
  344.  
  345.  
  346.           Parameter Definitions:
  347.           ----------------------
  348.  
  349.  
  350.  
  351.           /P - Prompt :
  352.  
  353.                Format: /p
  354.                Use: When this parameter is specified, COPYIT will
  355.                prompt you as to whether of not the file should be
  356.                copied.  You will  not  be  prompted for any files
  357.                that fail other selection criteria.
  358.  
  359.           /H - Hidden Files :
  360.  
  361.                Format: /h
  362.                Use:  Through DOS, a file can be marked as hidden.
  363.                Such a  file is not shown when a directory command
  364.                is given.  COPYIT normally ignores such files, but
  365.                will include them in the  copy  operation  if this
  366.                parameter is specified.
  367.  
  368.           /S - System Files :
  369.  
  370.                Format: /s
  371.                Use:  System files, much  like  hidden  files, are
  372.                normally  ignored  by  COPYIT.    Specifying  this
  373.                parameter will cause COPYIT to process them.
  374.  
  375.           /R - Read-Only Files :
  376.  
  377.                Format: /r
  378.                Use:  Through use  of  the  DOS ATTRIB command and
  379.                other  utilities, a file can be marked  read-only.
  380.                COPYIT   will  only  copy  these  files  if   this
  381.                parameter is specified.
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.                                    - 6 -
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.           /C - Check for Overlay :
  406.  
  407.                Format: /c
  408.                Use:  Normally, COPYIT operates much like  the DOS
  409.                COPY  command when copying a file  to  a  disk  or
  410.                subdirectory where an  identical  filename exists;
  411.                it overwrites the old file.  If you  are  not sure
  412.                what exists in the drive or subdirectory  that you
  413.                are copying to, or it you just want  to  know what
  414.                is being overlaid, specify this parameter.  COPYIT
  415.                will  then  check  if  a duplicate filename exists
  416.                before copying the file.   If it does, you will be
  417.                prompted as to  whether  or not the file should be
  418.                overlaid.
  419.  
  420.  
  421.           /Z - Copy based on File Size :
  422.  
  423.                Format: /z:[nnnn][+-]
  424.                Use:  This parameter allows you to specify copying
  425.                based upon file size.   The  format  is  as shown,
  426.                with [nnnn] equal to  the  file  size to be tested
  427.                against (this  can be any integer).  The file size
  428.                is then followed  by  either  a  plus  (+) telling
  429.                COPYIT to  copy all files equal to or greater than
  430.                the file size specified, or a  minus  (-), telling
  431.                COPYIT to copy all files equal to or less than the
  432.                filesize specified.  For example:
  433.  
  434.                                 /z:22000+
  435.  
  436.                would cause all files  equal  to  or  greater than
  437.                22000 bytes to be copied, while
  438.  
  439.                                 /z:1000000-
  440.  
  441.                specifies that only files equal  to  or  less than
  442.                1,000,000 bytes are to be copied.
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.                                    - 7 -
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.           /D - Copy based on File Date :
  473.  
  474.  
  475.                Format: /d:[date][+-]
  476.                Use:  This parameter causes COPYIT to select files
  477.                for copying  based  upon  the  date  the  file was
  478.                created or last modified.    After  the  '/d:' the
  479.                date you wish to test against  should  be entered.
  480.                Immediately  after  the  date,  either a plus (+),
  481.                indicating all files with dates equal to  or later
  482.                than the test date, or a minus (-), indicating all
  483.                files with dates equal to or before the test date,
  484.                must be entered.
  485.                     The date  may  be  entered  with  or  without
  486.                leading zeros.  Slashes, or any other non-numeric,
  487.                non-space  character my be substituted for  dashes
  488.                in the date.  For example, to copy all files on or
  489.                after August 9, 1988,  all  of  the  following are
  490.                valid:
  491.  
  492.                               /d:08-09-88+
  493.                               /d:8/9/88+
  494.                               /d:08/9-88+
  495.  
  496.                Similarly,  to copy all files created/modified  on
  497.                or after November 1, 1988, enter:
  498.  
  499.                               /d:11.1.88-
  500.                           or  /d:11-01-88-
  501.  
  502.           /A - Copy Based on Archive Bit :
  503.  
  504.  
  505.                Format: /a[+-]
  506.                Use:   Whenever a file is created or modified, DOS
  507.                turns on what  is  called the archive bit.  Backup
  508.                programs normally reset this  bit  so  that  it is
  509.                easy to determine what  files  have  changed since
  510.                the  last  backup.  COPYIT  normally  ignores  the
  511.                archive bit, copying the  file  regardless  of its
  512.                setting.  With the /a parameter, however,  you can
  513.                perform  copies   based   on   the   archive  bit.
  514.                Specifying  a  plus  (+)  sign after the parameter
  515.                tells COPYIT to  only  copy  files  that  have the
  516.                archive bit set (or turned on, indicating the file
  517.                has been created or modified).  Specifying a minus
  518.                (-) does the opposite; COPYIT will only copy files
  519.                that have an archive bit that is off.
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.                                    - 8 -
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.           /@ - Reset Archive Bit :
  540.  
  541.                Format: /@
  542.                Use:  As described under  the  /a  (copy  based on
  543.                archive bit) parameter, the archive  bit indicates
  544.                whether a file has been created/modified since the
  545.                last  backup.  If you want  COPYIT  to  reset  the
  546.                archive  bit  on  each  file  it  copies,  the  /@
  547.                parameter is used.
  548.  
  549.                WARNING:      Most   backup   utilities    perform
  550.                incremental backups based upon the settings of the
  551.                archive bit.  If  the  archive  bit has been reset
  552.                through the use of COPYIT (or any  other utility),
  553.                your incremental backups may  not  contain  all of
  554.                the  files  that  have been modified/created since
  555.                your last backup.
  556.  
  557.           /V - Verify During Copy :
  558.  
  559.                Format: /v
  560.                Use:   Specifying this parameter causes COPYIT  to
  561.                verify each write to  the  disk.    This is a time
  562.                consuming process - expect COPYIT to take twice as
  563.                long when /v is used.
  564.  
  565.           /M - Move Files :
  566.  
  567.                Format: /m
  568.                Use:  This parameter causes the files to be moved.
  569.                If moving from one  disk  to  another, the file is
  570.                first copied, then the original  is  deleted.   If
  571.                the file is  being moved between subdirectories on
  572.                the same disk, it is simply renamed.
  573.  
  574.           /O - Optimize During Copy :
  575.  
  576.  
  577.                Format: /o
  578.                Use:  Normally, COPYIT copies files  in  the order
  579.                they  occur  in  the  directory.    This   can  be
  580.                wasteful, especially if multiple target  diskettes
  581.                are needed to copy  all  of  the  files specified.
  582.                For  example, if the directory listed three  files
  583.                of sizes 75000, 10000, and 18000, COPYIT (and DOS)
  584.                would normally copy  them  in that order.  You may
  585.                have already copied many files to a  diskette, and
  586.                only have 45000 bytes free.   If you tried to copy
  587.                the  above  files to the  diskette,  COPYIT  would
  588.                immediately realize the first file is too  big for
  589.                the remaining  space  and  would  prompt  you  for
  590.                another  diskette.    If  /o is specific, however,
  591.                COPYIT would  fit as many files on the diskette as
  592.                possible  before  prompting  for another diskette.
  593.  
  594.  
  595.  
  596.                                    - 9 -
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.                Thus, the 18000 byte file  would  be  copied, then
  607.                the  10000  byte  file.    Since  no  more of  the
  608.                remaining files (the 75000 byte one)  will  fit on
  609.                the diskette, you would then be prompted to insert
  610.                another.
  611.                     This parameter  is  only  of  real  use  when
  612.                copying to multiple diskettes.   If  copying  to a
  613.                hard drive subdirectory, or if  all  of  the files
  614.                copied fit onto one diskette, the  only  effect is
  615.                that all files will be copied in  descending order
  616.                by size.
  617.  
  618.  
  619.           /T - Time Stamp Copied Files :
  620.  
  621.                Format: /t
  622.                Use:  When COPYIT copies  files  it  normally does
  623.                not change  the time/date stamp on the copies.  If
  624.                the /t parameter is used, the current  system data
  625.                and time will placed in  the  directory  entry for
  626.                the file.   The  original files' time and date are
  627.                never changed.
  628.  
  629.  
  630.           /W - Wait Between File Copies :
  631.  
  632.                Format: /w
  633.                Use:  Specifying this  parameter  cause  COPYIT to
  634.                wait for a keypress between each file copied.
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.                                   - 10 -
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.           EXAMPLES:
  674.  
  675.           copyit a:*.*
  676.  
  677.                Copies all files in the current directory of drive
  678.                A: to the current directory in  which  the command
  679.                was issued.
  680.  
  681.           copyit *.* \data /c /p
  682.  
  683.                Copies all files in  the  current  subdirectory to
  684.                subdirectory \DATA, prompting for each  file copy,
  685.                and  warning  if  any  files  in  \DATA   will  be
  686.                overlaid.
  687.  
  688.  
  689.           copyit ABC.TXT HELLO.TXT /m
  690.  
  691.                Since  no copyfrom or copyto paths are  specified,
  692.                and move (/m) is indicated,  the  file  ABC.TXT is
  693.                simply renamed to HELLO.TXT.
  694.  
  695.  
  696.           copyit \data\*.bak d:\olddata\*.old /c /m /d:11-1-88 /v
  697.  
  698.                Moves all  files  with  extensions  of  .BAK  from
  699.                directory   \DATA   to  drive   D:,   subdirectory
  700.                \OLDDATA.  The files'  extensions  are  renamed to
  701.                .OLD, and a warning  is  issued  if  any similarly
  702.                named files exist in \OLDDATA.  Only files created
  703.                or last  modified on or after November 1, 1988 are
  704.                moved.  Lastly, each file copy is verified.
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.                                   - 11 -
  731.  
  732.  
  733.